home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / spritemon.man < prev    next >
Encoding:
Text File  |  1989-10-17  |  4.5 KB  |  106 lines
  1. ' $Header: /a/newcmds/spritemon/RCS/spritemon.man,v 1.7 89/10/17 13:24:47 douglis Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS SPRITEMON cmds
  4. .BS
  5. .SH NAME
  6. spritemon \- X widget to display system events
  7. .SH SYNOPSIS
  8. \fBspritemon\fB -\fR[\fBuRafvpPiorw\fR] [\fB\-N \fInum\fR] [\fB-disks\fR] [\fB\-D \fInum\fR] [\fB\-T \fIinterval\fR] [\fB\-A \fIavailInterval\fR] [\fB\-%M\fR] [\fB\-H \fIheight\fR]
  9. .SH "OPTIONS"
  10. .IP "\fB\-T \fIinterval\fR"
  11. Sets the interval at which the display is updated.  Default is 5 seconds.
  12. .IP "\fB\-H \fIheight\fR"
  13. Sets the height of each graph displayed.  Default is 40 pixels.
  14. .IP "\fB\-u\fR"
  15. Display CPU utilization on a scale from 0.0 to 1.0.
  16. .IP "\fB\-N \fInum CPUs\fR"
  17. Do CPU utilization for more than one CPU.
  18. .IP "\fB\-R\fR"
  19. Display the number of remote processes belonging to this host (in 10's).
  20. .IP "\fB\-a\fR"
  21. Display the number of hosts to which this host can migrate (in 10's).
  22. .IP "\fB\-A \fIavailInterval\fR"
  23. Sets the interval at which the count of available hosts is updated.  
  24. Default is 15 seconds.
  25. .IP "\fB\-f\fR"
  26. Display file system cache size.
  27. .IP "\fB\-v\fR"
  28. Display amount of physical memory devoted to user virtual memory.
  29. .IP "\fB\-%\fR"
  30. Display cache size (\fB\-f\fR) or VM size (\fB\-v\fR) as a percentage of main memory.
  31. .IP "\fB\-M\fR"
  32. Display cache size (\fB\-f\fR) or VM size (\fB\-v\fR) in megabytes.
  33. .IP "\fB\-p\fR"
  34. Display the number of page-ins (in 100's).
  35. This is a sum of text, heap, and stack page-ins.
  36. .IP "\fB\-P\fR"
  37. Display the number of pages written out to swap files (in 100's).
  38. .IP "\fB\-i\fR"
  39. Display the number of ethernet packets received (in 100's).
  40. .IP "\fB\-o\fR"
  41. Display the number of ethernet packets sent out (in 100's).
  42. .IP "\fB\-disks\fR"
  43. Display disk statistics for all disks in the system (superceeds -D).
  44. .IP "\fB\-D \fInum\fR"
  45. Display disk #\fInum\fR utilization on a scale from 0.0 to 1.0.
  46. .IP "\fB\-r\fR"
  47. Display the number of disk read transfers (in 100's).  Use with \fB\-D\fR or \fB-disks\fP.
  48. .IP "\fB\-w\fR"
  49. Display the number of disk write transfers (in 100's).  Use with \fB\-D\fR or \fB-disks\fR.
  50. .BE
  51. .SH INTRODUCTION
  52. This widget displays operating system parameters as a running graph.
  53. It is an X toolkit widget and so it
  54. needs to run under the X window system.  This is a
  55. ``load widget'', which displays a value every \fIinterval\fP
  56. seconds, and has a title but no
  57. vertical scale.  Instead, horizontal lines are drawn
  58. to represent increments in the native unit of whatever
  59. is being displayed.  For some parameters, like
  60. percentage of memory devoted to the file system cache,
  61. the displayed value is always between 0 and 1 so there
  62. are no horizontal scale lines.  For the megabytes of
  63. filesystem cache there will be horizontal lines
  64. that represent megabytes, for remote processes there will be
  65. horizontal lines to represent 10's of remote processes,
  66. and for paging and network traffic there will be horizontal lines to
  67. represent 100's of events.
  68. The value displayed is truncated to the largest value that can
  69. be displayed without causing the horizontal lines to
  70. completely occupy the display.
  71. This value is equal to half the pane height.
  72. .PP
  73. Several system parameters can be viewed at once;
  74. the load meters are organized into a vertical pane with
  75. each meter of equal height.
  76. It is best to let spritemon determine its own geometry at startup
  77. (it will use the default pane height times the number of parameters being
  78. displayed),
  79. or you can specify a geometry argument on the command line
  80. and spritemon will evenly divide the window into panes.
  81. Otherwise, if you drag out a window size, the VPane widget
  82. does a poor job of picking the heights of individual panes.
  83. .PP
  84. The disk related options only work on machines with disks.
  85. The \fB\-D\fR option specifies which disk to display
  86. information about, or \fB-disks\fP can be used to display
  87. information about all the disks in the system.  Utilization is displayed,
  88. and \fB\-r\fR and \fB\-w\fR are used to display raw read and write counts.
  89. The number to specify to \fB\-D\fR corresponds to a kernel table entry
  90. that is indexed starting at zero.
  91. .SH "BUGS"
  92. .PP
  93. The \fB\-i\fR option needs to be glommed together with another option,
  94. i.e. \fB\-io\fR, or it gets interpreted by the X toolkit and \fBspritemon\fR
  95. starts out iconic.
  96. .PP
  97. The value of the argument to \fB\-D\fR is un-intuitive.
  98. .PP
  99. The disk information should display the file system name,
  100. but kernel support is needed for this.
  101. .SH "SEE ALSO"
  102. vmStat, migcmd
  103. .SH KEYWORDS
  104. system, page faults, file system cache, virtual memory, network
  105. interface, migration
  106.